渐进式披露（Progressive Disclosure）

概述

Claude Code Skills 的上下文管理策略——不一次性把所有内容塞进上下文，而是按需分三层加载：先看描述判断相关性，再加载 SKILL.md 核心说明，最后按需加载脚本和辅助文件。

关键内容

1. 三层加载机制：
2. 第一层：描述——Claude 扫描技能目录，根据描述判断 skill 是否匹配当前任务
3. 第二层：SKILL.md——读取核心说明和指令

4. 第三层：支持文件——如有需要，再加载脚本、模板、参考资料

5. 加载流程：

6. Claude 扫描技能目录
7. 根据描述判断是否匹配当前任务
8. 读取 SKILL.md

9. 如有需要，再加载脚本和辅助文件

10. 设计动机：上下文窗口有限，渐进式披露确保只加载当前任务真正需要的信息，避免上下文污染和 token 浪费。

11. 与上下文压缩的关系：渐进式披露是"预防性"策略（不让不需要的信息进入上下文），上下文压缩是"补救性"策略（当上下文过长时压缩旧内容）。两者互补。

来源

• 03-skills/README.md — Claude HowTo Agent Skills 指南

相关

• Agent Skills — implements
• 上下文窗口 — depends_on
• 上下文压缩 — relates_to